home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr49 / lgroom3.zip / README.1ST < prev    next >
Text File  |  1995-02-06  |  22KB  |  514 lines
  1.  
  2.                          LegRoom (tm) Version 3.0
  3.  
  4.                    (C) Copyright 1992-95 Phil Grenetz
  5.  
  6.                    Marketed by Ivden Technologies, Inc.
  7.                              Churchville, PA
  8.  
  9.  
  10.  
  11.               _______
  12.          ____|__     |               (R)
  13.       --|       |    |-------------------         Thanks,
  14.         |   ____|__  |  Association of
  15.         |  |       |_|  Shareware                 Phil Grenetz
  16.         |__|   o   |    Professionals             Ivden Technologies, Inc.
  17.       -----|   |   |---------------------
  18.            |___|___|    MEMBER
  19.  
  20.  
  21.  ==============================================================================
  22.                     
  23.                     TABLE OF CONTENTS
  24.                     -----------------
  25.  
  26. 1.  INTRODUCTION TO LEGROOM
  27.  
  28. 2.  SHAREWARE CONCEPT
  29.  
  30. 3.  ACKNOWLEDGMENTS
  31.  
  32. 4.  PACKING LIST
  33.  
  34. 5.  INSTALLATION
  35.  
  36. 6.  HOW TO USE LEGROOM
  37.  
  38. 7.  USAGE NOTES
  39.  
  40. 8.  DISCLAIMER
  41.  
  42. 9.  DISTRIBUTION POLICY AND LICENSE
  43.  
  44. 10. WHY AND HOW TO BECOME A REGISTERED USER
  45.  
  46. 11.  CLOSING WORD
  47.  
  48. 1.  INTRODUCTION TO LEGROOM
  49.     -----------------------
  50.  
  51. LegRoom Ver. 3.0 is a TSR maker and task swapper for DOS-based
  52. personal computers.
  53.  
  54. LegRoom is published by Ivden Technologies, Inc. as part of its
  55. line of memory resident utilities.  LegRoom was designed to solve
  56. two problems:
  57.  
  58.  a) shelling to DOS from programs that don't have a DOS shell
  59.     function
  60.  
  61.  b) shelling from programs whose shell function gives too little
  62.     memory at the DOS prompt to do any useful work.
  63.  
  64. LegRoom allows you to Shell to DOS from any text and most
  65. graphic  applications.  It loads as a TSR (Terminate and Stay
  66. Resident) program and is triggered when you press a hot key.
  67.  
  68. LegRoom also lets you make any program (even a DOS batch file) pop
  69. up as a TSR when you press the hot keys.
  70.  
  71. In addition, starting with Version 3.0, LegRoom allows you to create
  72. a menu which will pop up and present you with up to 9 program commands
  73. (and the DOS prompt) to select from when triggered by pressing the hot
  74. keys.
  75.  
  76. LegRoom will run under DOS 2.0 and up.
  77.  
  78. 2.  SHAREWARE CONCEPT
  79.     -----------------
  80.  
  81. "Shareware" is a term used to describe a system for distribution of
  82. software.  Under the shareware concept, software may be freely
  83. copied and passed along to others, or distributed through bulletin
  84. board systems, shareware distribution companies, etc.
  85.  
  86. As a recipient of a shareware program, you may use the software for
  87. a short trial period to determine if it meets your needs.  If it
  88. does, you pay the registration fee.  By paying the fee, you are
  89. granted the right to retain the software for your use.  If the
  90. software is not suitable, then you may discard it.
  91.  
  92. The shareware system provides substantial benefits to the computing
  93. community (of which YOU are a member):
  94.  
  95.  a) You get to try out the software BEFORE you buy it so you know
  96.     exactly what you're buying.
  97.  
  98.  b) Shareware is substantially less expensive than most commercial
  99.     programs.  You don't pay for costly marketing programs and
  100.     fancy packaging.
  101.  
  102.  c) You get access to a MUCH broader base of available programs.
  103.     Thousands of excellent programs have been written by expert
  104.     programmers who would never consider marketing commercially.
  105.  
  106. Through the concept of shareware, these people make their
  107. programs available to the community.  Usually, all they ask in
  108. return is a small fee to reward them for the time and effort
  109. they've put into the program.
  110.  
  111. The system is based entirely on the honor system, and generally
  112. works quite well.  (Most people are honest and wouldn't violate the
  113. trust placed in them by the author of the software.)
  114.  
  115. Shareware is NOT free software - the author counts on your
  116. integrity.  See Why and How to Become a Registered User.
  117.  
  118. You are encouraged to copy this software and pass it along to
  119. others who may be interested in using it.
  120.  
  121. 3.  ACKNOWLEDGMENTS
  122.     ---------------
  123.  
  124. LegRoom(tm) was developed by Phil Grenetz and is published by
  125. Ivden Technologies, Inc. as part of a line of memory resident
  126. utilities.
  127.  
  128.                (c) Copyright 1992-95 Phil Grenetz
  129.  
  130. 4.  PACKING LIST
  131.     ------------
  132.  
  133. LEGROOM.EXE         Executable File
  134. SAMPLE.MNU          Sample Menu File you can Edit and Use
  135. REGISTER.FRM        Registration Form
  136. README.1ST          Conventional Documentation File
  137. UPDATE.DOC          Release History (changes since initial version)
  138. VENDOR.DOC          Shareware Vendor Distribution Policy Statement
  139. BBS.DOC             Bulletin Board Distribution Policy Statement
  140. SUPPORT.DOC         Tech Support Policy
  141. OMBUDSMN.DOC        ASP Ombudsman Statement
  142. FEEDBACK.DOC        Sample Comments from Users of LegRoom
  143. FILE_ID.DIZ         Old Standard Product Description File
  144. VENDINFO.DIZ        New Standard Product Description File
  145.  
  146.  
  147. 5.  INSTALLATION
  148.     ------------
  149.  
  150. Install the program by following these steps:
  151.  
  152. a) Copy the file LGROOM30.ZIP to the directory of your choice
  153.  
  154. b) Extract the compressed contents by using the shareware
  155.    decompression program PKUNZIP.  If you don't have a copy,
  156.    you can probably get one where you obtained LegRoom.  You can
  157.    download it from most BBSs and info services, e.g., CompuServe.
  158.  
  159. 6.  HOW TO USE LEGROOM
  160.     ------------------
  161.  
  162. LegRoom runs on any IBM compatible computer running MS-DOS,
  163. Version 2.0 and up, or 100% compatible operating system.
  164.  
  165. The most powerful way to use LegRoom is to create a menu which will
  166. pop up when you press the hot keys.  See the file sample.mnu included
  167. with the package as an example.  Edit it with any editor that can read
  168. and write ASCII text files.  You may include up to nine (9) commands,
  169. including executable programs or batch files, in the following format:
  170.  
  171.    Command Name  =  drive:\path\progname.[exe|com|bat] parameters
  172.  
  173. Command Name is the text displayed in the menu presented when you
  174. press the hot keys.  The actual command specification to the right of
  175. the equal sign ('=') is executed if the cooresponding menu option is
  176. selected.  It is not displayed as part of the menu.
  177.  
  178. In addition to the commands you include in the menu file, LegRoom
  179. automatically adds "Shell to DOS" as an option above the others.
  180.  
  181. In order for LegRoom to present the command menu when you press the hot
  182. keys, it must know what the menu file is named and where to find it.
  183. When LegRoom is triggered, it looks for a menu file identified by the
  184. LR_DATA environment variable.  It is recommended that you set this
  185. variable in your AUTOEXEC.BAT file so that it is set automatically
  186. whenever you boot your computer.  Otherwise, the menu will not appear.
  187.  
  188. Load LegRoom by entering the command LEGROOM from the directory
  189. where you installed it.  You can also add that command to your
  190. AUTOEXEC.BAT file to load LEGROOM whenever you boot your computer.
  191. That way, it will stay in memory for use whenever you need it.
  192.  
  193. When you press the hot keys, the current application is suspended.
  194. It is moved to a holding area in extended memory, expanded memory,
  195. or your hard disk, depending on which is available.
  196.  
  197. The program, its data, video memory, mouse and floating point
  198. coprocessor state, and your current drive and directory are saved.
  199.  
  200. If you shell to DOS, type EXIT when you are finished running other
  201. programs.  You will be returned to the suspended application.  If,
  202. instead, you launched another application from LegRoom, you will, on
  203. termination, be automatically returned to the suspended application.
  204. Its state is restored to that saved prior to pressing the hot keys.
  205.  
  206. LegRoom auto-detects the presence of extended and expanded
  207. memory and takes advantage of them.  If available, it loads itself
  208. into expanded memory, taking up less than 2 KB of conventional memory.
  209.  
  210. You needn't have an expanded memory board to have expanded memory.
  211. Memory managers such as EMM386, QEMM386, 386MAX, and Memory Commander
  212. emulate expanded memory for applications which call for it.
  213.  
  214. There are nine (9) command line parameters you can use to control the
  215. behavior of LegRoom.  These parameters are described below:
  216.  
  217.        LEGROOM [/D | /N] [/H] [/P] [/M] [/R=p] [/B=p] [/U] [/?],
  218.  
  219. where:
  220.  
  221.        /D   creates a temporary disk file for holding the current
  222.             application, instead of using extended or expanded memory
  223.  
  224.        /N   uses extended memory, if available, for holding the
  225.             current application, but DOES NOT use expanded memory
  226.             (this makes it run compatibly with QEMM in 'stealth' mode
  227.              and the NetWare driver EMSNET)
  228.  
  229.        /H   prompts you for hot keys other than the default,
  230.             Ctrl-Shift-0, to press when you want to trigger LegRoom
  231.  
  232.        /P   suppress replacement of DOS prompt when shelling,
  233.             for users of DOS shell replacements (e.g., 4DOS) with
  234.             special prompt features
  235.  
  236.        /M   disable protection against swapping out TSRs loaded after
  237.             LegRoom (for special situations -- see discussion below)
  238.  
  239.        /R=p causes any program or DOS batch file to be run when the
  240.             hot keys are pressed (p is the complete path and file
  241.             specification, including .exe, .com, or .bat extension,
  242.             and optional command line) -- control returns to the
  243.             suspended application automatically
  244.  
  245.        /B=p works just like /R=p except that it's only for batch files
  246.             and it does not automatically return to the suspended
  247.             application
  248.  
  249.        /U   unloads LegRoom from memory (you cannot unload it when
  250.             you have shelled to DOS using it)
  251.  
  252.        /?   displays help information without loading LegRoom.
  253.  
  254. To trigger LegRoom, press the default hot keys or the hot keys
  255. you pressed when prompted if you used the /H parameter as described
  256. above.  If you took the default hot keys, use the '0' on the row of
  257. standard number keys on your keyboard, NOT THE NUMERIC KEYPAD.
  258.  
  259. 7.  USAGE NOTES
  260.     -----------
  261.  
  262. You can load LegRoom into upper memory with the "load high"
  263. facilities of a memory manager.  This saves a small amount of
  264. conventional memory.  The amount of the savings is greater when using
  265. the /N or /D switch.  These switches prevent a 386 based memory
  266. manager from loading most of LegRoom into expanded memory.
  267.  
  268. Ctrl-Break is disabled at the new DOS prompt after triggering
  269. LegRoom.  Use Ctrl-C instead of Ctrl-Break to break out of a
  270. process launched from the new DOS prompt.
  271.  
  272. DON'T SHELL FROM A SHELL!  If you loaded LegRoom without the /R=
  273. switch, you cannot trigger LegRoom when at the DOS prompt.  This
  274. would be a waste of memory or disk space.  However, LegRoom does
  275. not detect the presence of a DOS prompt created by using a program's
  276. built-in shell feature.  Use one or the other, but not both.
  277.  
  278. You can use LegRoom from multitasking environments such as
  279. DesqView and Microsoft Windows.  The advantages of LegRoom are
  280. greatest in a single tasking DOS environment.  If you decide to use
  281. LegRoom in a multitasking environment, be sure to load it from within
  282. a DOS 'box' or DOS 'window', NOT before entering the environment!
  283.  
  284. Do not use LegRoom to shell from a communication program while
  285. transferring data.  Shelling with LegRoom suspends the current
  286. application.  It does NOT keep running in the background.  Data will
  287. be lost if you use LegRoom to shell to DOS while performing a
  288. file transfer.
  289.  
  290. You should, in general, not load a TSR into memory when you have
  291. shelled to DOS from an application.  When you exit the application,
  292. your conventional memory pool has a 'hole' where the application was.
  293. This is called fragmentation.  It reduces the largest block of memory
  294. available to programs.
  295.  
  296. LegRoom creates a small DOS batch file when you use LegRoom to shell
  297. to DOS.  If it is necessary for LegRoom to create this batch file or
  298. a swap file, it is created in the directory identified by the LR_TEMP
  299. environment variable.  It is recommended that you set this variable in
  300. your AUTOEXEC.BAT file so that it is set automatically whenever you
  301. boot your computer.  Otherwise, these temporary files are stored in a
  302. subdirectory named 'TEMP' under the directory where you installed
  303. LegRoom.
  304.  
  305. LegRoom supports any number of concurrent users on a network.
  306. Each user should be assigned a unique directory in his/her LR_TEMP
  307. environment variable to avoid 'collisions'.  Similarly, if you use
  308. LegRoom in multiple DOS sessions in DesqView or Microsoft Windows, and
  309. expect it to use disk space for swapping or to shell to DOS, set
  310. LR_TEMP to a different directory in each session before loading
  311. LegRoom.
  312.  
  313. The swap file, named lr.swp, is created with System and Read-Only
  314. attributes to reduce the risk of deletion or renaming while LegRoom is
  315. loaded.
  316.  
  317. Each time LegRoom is loaded, the old swap file (if any) is replaced by
  318. a new one.  The attributes of the old swap file are returned to normal
  319. on unloading LegRoom.  That way, if you have used LegRoom with several
  320. different temporary file directories, you can find the swap files and
  321. delete them.  Rebooting or turning off the computer without first
  322. unloading LegRoom defeats this feature, resulting in the current swap
  323. file remaining invisible with the System and Read-Only attributes.
  324.  
  325. The /M switch is for use only in case of a program which installs
  326. interrupt handlers. LegRoom, by default, will avoid swapping it out
  327. because it looks like a TSR.
  328.   
  329. A TSR whose interrupt handlers may be called needs to be kept in
  330. memory.  However, a non-resident application which installs
  331. interrupt handlers, such as a laboratory data analysis program, may
  332. be safe to swap out of memory.  If not swapped, it may consume 100's
  333. of KB of conventional RAM, limiting the effectiveness of LegRoom in
  334. this situation.  When used with an application of this type and no
  335. other TSRs are loaded after LegRoom, it is safe to use /M.
  336. In short, EXERCISE CAUTION IN USING THE /M SWITCH.
  337.  
  338. A conflict has been reported with the Identity Mouse Driver by
  339. Technology Corp.  If you use this mouse driver and experience problems
  340. with LegRoom, try loading LegRoom in your AUTOEXEC.BAT file before you
  341. load the mouse driver.
  342.  
  343. Always load LegRoom after the smartdrv hard disk cache utility.
  344. Otherwise, it is possible that pressing Ctrl-Alt-Del when shelled
  345. to DOS via LegRoom will cause a reboot before the write cache is
  346. flushed to the disk.  Losing recent writes can be harmful, especially
  347. if you use a disk compression utility.  This may be a good practice
  348. in general, even if you use another disk cache utility.
  349.  
  350. Always, load LegRoom after a keyboard enhancer (e.g., keyfake).
  351. Otherwise, it is possible that characters passed to the keyboard
  352. buffer by the enhancer will appear when you return to the previous
  353. application.
  354.  
  355. LegRoom's conventional memory "footprint" is quite small, only 1328
  356. bytes if expanded memory is available,  However, if memory swapping
  357. is being used rather than disk swapping, anywhere from 500-900K of
  358. expanded or extended memory will be allocated for LegRoom's use to
  359. hold the foreground application, video memory, other physical state
  360. information.  If other applications need that memory, use the /D
  361. command line switch to request disk swapping.  There will be a
  362. perceptible delay when you press the hot keys, but you will have full
  363. access to your memory.
  364.  
  365. LegRoom supports all standard graphic adapters and modes as well
  366. as Super VGA modes up to a maximum video memory requirement of 256 KB.
  367.  
  368. 8.  DISCLAIMER
  369.     ----------
  370.  
  371. IVDEN TECHNOLOGIES, INC. (IVDEN) HEREBY DISCLAIMS ALL WARRANTIES
  372. RELATING TO THIS SOFTWARE, WHETHER EXPRESS OR IMPLIED, INCLUDING
  373. WITHOUT LIMITATION ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR
  374. FITNESS FOR A PARTICULAR PURPOSE. IVDEN WILL NOT BE LIABLE FOR ANY
  375. SPECIAL, INCIDENTAL, CONSEQUENTIAL, INDIRECT OR SIMILAR DAMAGES DUE
  376. TO LOSS OF DATA OR ANY OTHER REASON, EVEN IF IVDEN OR AN AGENT OF
  377. IVDEN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  IN NO
  378. EVENT SHALL IVDEN'S LIABILITY FOR ANY DAMAGES EVER EXCEED THE PRICE
  379. PAID FOR THE LICENSE TO USE THE SOFTWARE, REGARDLESS OF THE FORM OF
  380. THE CLAIM.  THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE
  381. QUALITY AND PERFORMANCE OF THE SOFTWARE.
  382.  
  383.  
  384. 9.  DISTRIBUTION POLICY AND LICENSE
  385.     -------------------------------
  386.  
  387.    Distribution Policy
  388.    -------------------
  389.  
  390. ANY ORGANIZATION DISTRIBUTING LEGROOM FOR ANY KIND OF REMUNERATION
  391. IS AUTHORIZED TO DO SO IF IT ADHERES TO THE GUIDELINES OF THE
  392. ASSOCIATION OF SHAREWARE PROFESSIONALS (ASP) FOR SHAREWARE
  393. DISTRIBUTORS.
  394.  
  395. Permission to distribute the LegRoom package is not transferable,
  396. assignable, saleable, or franchisable.  Each vendor wishing to
  397. distribute the package must independently satisfy the terms of
  398. this limited distribution license.
  399.  
  400. U.S. Government Information:  Use, duplication, or disclosure by the
  401. U.S. Government of the computer software and documentation in this
  402. package shall be subject to the restricted rights applicable to
  403. commercial computer software as set forth in subdivision (b)(3)(ii) of
  404. the Rights in Technical Data and Computer Software clause at
  405. 252.227-7013 (DFARS 52.227-7013).  The Contractor/manufacturer is
  406. Ivden Technologies, Inc., 87 Arbor Road, Churchville, PA 18966-1007.
  407. Ivden Technologies, Inc. may revoke any permissions granted here, by
  408. notifying you in writing.  All rights not expressly granted here are
  409. reserved to Ivden Technologies, Inc.
  410.  
  411.    License to Use LegRoom(tm)
  412.    ----------------------
  413.  
  414. LegRoom is a copyrighted software package. It is being 
  415. distributed as user supported shareware. By using or distributing 
  416. this package, you agree to the following:
  417.  
  418. You are granted a limited license to try this program, LegRoom,
  419. for 30 days. If you find this software useful and wish to continue 
  420. using it after the 30 day evaluation period, you must pay the 
  421. registration fee.  Registration for use on a single personal computer 
  422. is $35.00 + Shipping & Handling.  You may, instead, register for
  423. installation on a local area network (LAN) server.  The LAN
  424. registration fee of $99 permits an unlimited number of concurrent
  425. users on theregistered server.
  426.  
  427. Register for each personal computer and each LAN server on which 
  428. LegRoom is installed. See Why and How to Become a Registered User.
  429.  
  430. No other license or rights are granted by implication or otherwise.
  431. After evaluating LegRoom, if you continue to use it, you MUST
  432. register.
  433.  
  434.  
  435. NOTE TO DEVELOPERS:
  436. If you would like to seamlessly integrate the LegRoom technology
  437. into programs you distribute for profit, Ivden Technologies, Inc.
  438. maintains an interrupt-triggered version.  The developer version of
  439. LegRoom loads in advance of your program and resides in memory
  440. as an interrupt service routine dedicated to your program(s).  You 
  441. just call a specified interrupt and the DOS shell is triggered.  
  442.  
  443. No saving / restoring your screen.  No worrying about how little 
  444. memory will available for your 'child' program or at the DOS prompt.
  445. LegRoom takes care of everything.  No link libraries to bother
  446. with.  No memory models or compatibility issues to hassle with.
  447. Any language which has an interrupt call function is supported.
  448.  
  449. Contact Ivden Technologies, Inc. for our very reasonable runtime 
  450. license fee.
  451.  
  452. 10. WHY AND HOW TO BECOME A REGISTERED USER
  453.     ---------------------------------------
  454.  
  455. In exchange for registering your copy of LegRoom, you will
  456. receive:
  457.  
  458.   - a printed manual
  459.  
  460.   - the current version without the registration reminder
  461.  
  462.   - the next version of LegRoom when it is available.
  463.  
  464. In addition, you will receive a listing of other Ivden products.
  465.  
  466. To register, do one of the following:
  467.  
  468.    - fill out the registration form (see REGISTER.FRM) and send it
  469.      or a note with the applicable registration fee to:
  470.  
  471.                      Ivden Technologies, Inc.
  472.                      87 Arbor Road
  473.                      Churchville, PA 18966-1007
  474.  
  475.    - register via the CompuServe Information Service:
  476.      GO SWREG and select Register Shareware
  477.      (LegRoom is Product Number 2833)
  478.  
  479.    - order by credit card from Public (software) Library
  480.      PsL accepts MasterCard, Visa, Amex, and Discover Cards
  481.      (800) 2424-PsL or (713) 524-6394 (Voice)
  482.      (713) 524-6398 (FAX)
  483.      CompuServe e-mail at 71355,470.
  484.      7:00 am to 7:00 pm CST Monday-Friday
  485.      7:00 am to 4:00 pm on weekends
  486.      (LegRoom is Product Number 11409)
  487.  
  488.      PsL also takes orders at P.O.Box 35705, Houston, TX 77235-5705.
  489.      Use a credit card or a check or money order in U.S. dollars
  490.      drawn on a U.S. bank.
  491.  
  492.      THE ABOVE PHONE NUMBERS ARE FOR ORDERS ONLY.
  493.      Any questions about the status of an order, refunds, registration
  494.      options, volume discounts, site licenses, dealer pricing, product
  495.      details, technical support, etc, must be directed to:
  496.                      Ivden Technologies, Inc.
  497.                      87 Arbor Road
  498.                      Churchville, PA 18966-1007
  499.                      (610) 328-1145 (Voice or FAX)
  500.                      CompuServe ID: 71221,3602
  501.                      Support BBS: (215) 322-5114
  502.  
  503. Please read the files SUPPORT.DOC and OMBUDSMN.DOC.  They define
  504. the support you can expect from Ivden Technologies, Inc. and the ASP
  505. when you become a registered user of LegRoom.
  506.  
  507. 11. CLOSING WORD
  508.     ------------
  509.  
  510. We hope you find that LegRoom makes your DOS environment more
  511. productive.  If you like the product, please register it.  If you
  512. have comments -- positive or negative -- please share them with us.
  513.  
  514.